Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COROOT_API_KEY | No | API key (limited to data ingestion only) | |
| COROOT_BASE_URL | Yes | Your Coroot instance URL | |
| COROOT_PASSWORD | No | Password for basic authentication | |
| COROOT_USERNAME | No | Username for basic authentication | |
| COROOT_SESSION_COOKIE | No | Session cookie for SSO/MFA users |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_current_user | Get current authenticated user information. Returns information about the currently authenticated user including their email, name, roles, and accessible projects. |
| list_projects | List all accessible projects. Returns a list of all projects that the authenticated user has access to. Each project includes its ID and name. |
| get_project | Get project details and configuration. Retrieves comprehensive information about a project including its settings, integrations, and configuration. Args: project_id: Project ID |
| create_project | Create a new project. Creates a new Coroot project with the specified name. The name must contain only lowercase letters, numbers, and hyphens. Args: name: Project name (must match ^a-z0-9?$) |
| get_project_status | Get project status including agent and integration health. Returns the current status of a project including:
Args: project_id: Project ID |
| get_application | Get application details and metrics. Retrieves comprehensive information about an application including:
Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp for metrics (optional) to_timestamp: End timestamp for metrics (optional) |
| get_application_logs | Get application logs with pattern analysis. Retrieves application logs with automatic pattern detection and grouping. Supports filtering by time range, search query, and severity level. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp (optional) to_timestamp: End timestamp (optional) query: Log search query (optional) severity: Filter by severity level (optional) |
| get_application_traces | Get distributed traces for an application. Retrieves distributed tracing data showing request flow through the application and its dependencies. ⚠️ WARNING: This endpoint can return very large responses (100k+ tokens) when retrieving many traces. Consider using time filters or trace_id to limit the response size. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp (optional, recommended to limit data) to_timestamp: End timestamp (optional, recommended to limit data) trace_id: Specific trace ID to retrieve (optional, returns single trace) query: Search query (optional) |
| get_applications_overview | Get overview of all applications in a project. Returns a high-level view of all applications including:
Args: project_id: Project ID query: Search/filter query (optional) |
| get_nodes_overview | Get overview of infrastructure nodes. Returns information about all nodes in the infrastructure:
Args: project_id: Project ID query: Search/filter query (optional) |
| get_traces_overview | Get distributed tracing overview. Returns a summary of distributed traces across all applications:
Args: project_id: Project ID query: Search/filter query (optional) |
| get_deployments_overview | Get deployment tracking overview. Returns information about recent deployments:
Args: project_id: Project ID query: Search/filter query (optional) |
| get_risks_overview | Get risk assessment overview. Returns comprehensive risk analysis across all applications:
Args: project_id: Project ID query: Search/filter query (optional) |
| list_integrations | List all configured integrations for a project. Returns the configuration status of all available integrations:
Args: project_id: Project ID |
| configure_integration | Configure an integration for a project. Sets up or updates an integration configuration. Each integration type has specific configuration requirements. Integration types:
Args: project_id: Project ID integration_type: Type of integration config: Integration-specific configuration dictionary |
| list_inspections | List all available inspections for a project. Returns a list of all inspection types and their configurations including CPU, memory, SLO, and other health checks. Args: project_id: Project ID |
| get_inspection_config | Get inspection configuration for an application. Retrieves the current configuration for a specific inspection type (e.g., cpu, memory, slo_availability, slo_latency) for an application. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) inspection_type: Type of inspection (cpu, memory, slo, etc) |
| update_inspection_config | Update inspection configuration for an application. Updates the configuration for a specific inspection type. Configuration format depends on the inspection type. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) inspection_type: Type of inspection (cpu, memory, slo, etc) config: New configuration (format varies by type) |
| get_application_categories | Get application categories configuration. Returns the current application categorization rules that determine how applications are grouped (e.g., monitoring, control-plane, etc). Args: project_id: Project ID |
| update_application_categories | Update application categories configuration. Updates the rules for categorizing applications. Categories can include custom patterns for matching applications by namespace, name, etc. Args: project_id: Project ID categories: New categories configuration with patterns |
| get_custom_applications | Get custom applications configuration. Returns the list of custom application definitions that group instances by patterns. Args: project_id: Project ID |
| update_custom_applications | Update custom applications configuration. Updates the list of custom application definitions. Custom applications allow grouping instances by container name patterns. Args: project_id: Project ID applications: New custom applications list with instance patterns |
| get_application_rca | Get AI-powered root cause analysis for application issues. Analyzes application problems and provides insights into the root causes of incidents, performance degradation, or failures. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) |
| get_application_profiling | Get CPU and memory profiling data for an application. Retrieves profiling data including flame graphs for CPU usage and memory allocation patterns to help identify performance bottlenecks and optimization opportunities. ⚠️ WARNING: This endpoint can return extremely large responses (180k+ tokens) for applications with extensive profiling data. Consider using time filters to limit the response size to specific time windows. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) from_timestamp: Start timestamp (optional, strongly recommended) to_timestamp: End timestamp (optional, strongly recommended) query: Search query (optional) |
| update_application_risks | Update risk assessment configuration for an application. Configures risk thresholds and monitoring parameters to better identify potential issues before they impact users. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) risks: Risk assessment configuration |
| get_db_instrumentation | Get database instrumentation configuration. Retrieves instrumentation settings for a specific database type. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) db_type: Database type (mysql, postgres, redis, mongodb, memcached) |
| update_db_instrumentation | Update database instrumentation configuration. Configures how Coroot instruments and monitors a specific database. Args: project_id: Project ID app_id: Application ID (format: namespace/kind/name) db_type: Database type (mysql, postgres, redis, mongodb, memcached) config: Instrumentation configuration |
| get_node | Get detailed information about a specific infrastructure node. Retrieves comprehensive metrics and information about a node including:
Args: project_id: Project ID node_id: Node ID |
| get_incident | Get detailed information about a specific incident. Retrieves comprehensive incident information including:
Args: project_id: Project ID incident_id: Incident ID |
| list_dashboards | List all custom dashboards for a project. Returns all user-created dashboards with their configurations. Args: project_id: Project ID |
| create_dashboard | Create a new custom dashboard. Creates a dashboard with custom panels and queries for monitoring specific aspects of your infrastructure. Args: project_id: Project ID dashboard: Dashboard configuration with panels and layout |
| get_dashboard | Get a specific dashboard configuration. Retrieves the full configuration of a dashboard including all panels. Args: project_id: Project ID dashboard_id: Dashboard ID |
| update_dashboard | Update an existing dashboard configuration. Updates dashboard panels, layout, or other settings. Args: project_id: Project ID dashboard_id: Dashboard ID dashboard: Updated dashboard configuration |
| delete_dashboard | Delete a custom dashboard. Permanently removes a dashboard from the project. Args: project_id: Project ID dashboard_id: Dashboard ID |
| test_integration | Test an integration configuration. Verifies that an integration is properly configured and can connect. Args: project_id: Project ID integration_type: Type of integration (prometheus, slack, etc) |
| delete_integration | Delete an integration configuration. Removes an integration from the project. Args: project_id: Project ID integration_type: Type of integration to delete |
| update_project_settings | Update project settings and configuration. Updates project-level settings such as retention, alerting, etc. Args: project_id: Project ID settings: Updated project settings |
| delete_project | Delete a project and all associated data. WARNING: This action is irreversible and will delete all project data. Args: project_id: Project ID |
| list_api_keys | List all API keys for a project. Returns all API keys with their metadata (but not the secret values). Args: project_id: Project ID |
| create_api_key | Create a new API key for data ingestion. Creates an API key that can be used for sending metrics and data. The key secret is only returned once during creation. Args: project_id: Project ID name: API key name description: Optional description |
| update_current_user | Update current user information. Updates the profile of the currently authenticated user. Args: user_data: Updated user information |
| list_users | List all users in the system (admin only). Returns all users with their roles and permissions. Requires admin privileges. |
| create_user | Create a new user (admin only). Creates a new user account with specified role and permissions. Requires admin privileges. Args: user_data: New user information including email, name, role |
| get_roles | Get available user roles. Returns all available roles that can be assigned to users (e.g., Viewer, Editor, Admin). |
| get_custom_cloud_pricing | Get custom cloud pricing configuration. Retrieves any custom cloud pricing overrides for cost calculations. Args: project_id: Project ID |
| update_custom_cloud_pricing | Update custom cloud pricing configuration. Sets custom pricing for cloud resources to override default pricing. Args: project_id: Project ID pricing: Custom pricing configuration |
| delete_custom_cloud_pricing | Delete custom cloud pricing configuration. Removes custom pricing overrides and reverts to default pricing. Args: project_id: Project ID |
| health_check | Check if Coroot server is healthy. Performs a simple health check to verify that the Coroot server is running and accessible. |
| get_sso_config | Get SSO configuration. Retrieves Single Sign-On (SSO) configuration and available roles. |
| update_sso_config | Update SSO configuration. Configures Single Sign-On settings for the Coroot instance. Args: config: SSO configuration settings |
| get_ai_config | Get AI provider configuration. Retrieves AI provider settings used for root cause analysis. |
| update_ai_config | Update AI provider configuration. Configures AI provider settings for enhanced root cause analysis. Args: config: AI provider settings (API keys, model selection, etc.) |
| get_panel_data | Get data for a specific dashboard panel. Retrieves the data that powers a specific panel in a custom dashboard, including metrics, time series data, or aggregated values. Args: project_id: The project ID dashboard_id: The dashboard ID panel_id: The panel ID within the dashboard from_time: Optional start time (ISO format or relative like '-1h') to_time: Optional end time (ISO format or 'now') |
| get_integration | Get specific integration configuration details. Retrieves the current configuration for a specific integration type, including connection details, settings, and status. Args: project_id: The project ID integration_type: Type of integration (prometheus, cloudwatch, etc.) |
| configure_profiling | Configure CPU and memory profiling for an application. Enables or disables continuous profiling and sets the sampling rate for collecting CPU and memory profiles. Args: project_id: The project ID app_id: The application ID enabled: Whether to enable profiling sample_rate: Optional sampling rate (0.0-1.0) |
| configure_tracing | Configure distributed tracing for an application. Controls trace collection settings including sampling rate and paths to exclude from tracing. Args: project_id: The project ID app_id: The application ID enabled: Whether to enable tracing sample_rate: Optional trace sampling rate (0.0-1.0) excluded_paths: Optional list of URL paths to exclude |
| configure_logs | Configure log collection settings for an application. Controls which logs are collected and processed, including log level filtering and pattern exclusions. Args: project_id: The project ID app_id: The application ID enabled: Whether to enable log collection level: Optional minimum log level (debug, info, warn, error) excluded_patterns: Optional regex patterns to exclude |
| create_or_update_role | Create or update a user role (admin only). Defines custom roles with specific permissions for fine-grained access control. Args: name: Role name permissions: List of permission strings description: Optional role description |